GetMouse4Prog is a utility for track mouse coordinate and get them in the clipboard embedded in a structured text.
This can be a lot useful for programmers.
You can collect:
- the current mouse position (POINT)
- 2 successive mouse positions (RECT)
- a list of successive point (LIST)
Running GetMouse4Prog it will display its main window.
The main window will show the current mouse position.
Moving the mouse you can see the coordinate are updated instantly as you move the mouse.
Mouse coordinate are update also when GetMouse4Prog is in background.
• Using a Custom Origin
Coordinates are referred from the top left corner of the monitor.
To use a different origin move the cursor on the new desired origin and press M (as Mouse) Key on the keyboard.
Coordinate will be displayed using the new origin.
In any moment you can activate a new origin pressing the M key on your keyboard.
To restore de default origin (the top left corner of the monitor press the E key.
• Copying mouse coordinates.
To copy mouse coordinates press on the keyboard the C key.
The current mouse coordinate, in the format specified in preferences, will be copied in the clipboard.
Now you can switch to your editor and paste.
SetPoint(&pt, 486,431);
Note that you didn't pasted simply mouse coordinate but a text containing the collected coordinate.
This text is specified in the preference.
Open Preferences from the Edit menu to have a look.
As you can see the single point text is :
SetPoint(&pt, X , Y );
where X and Y are the horizontal and vertical mouse position.
Changing the text in the preference dialog you can change the text you obtain when you collect mouse coordinate.
To obtain only the mouse coordinate simply remove the text from the field in the preference dialog.
• Getting a rect coordinate
To collect a rect (identified by 2 points) move the mouse on the position of the top-left corner of the desired rect, press on the keyboard the R key (as the first letter of the word 'Rect'), and you will collect the first point identifying the rect.
Than move the mouse in the position of the bottom-right corner of the desired rect and than press on the keyboard the T key (as the last part of the word RECT)
You have now in the clipboard the 2 mouse coordinate embedded in the text specified in the preferences in the RECT option.
SetRect(&r,338,168,581,427);
• Getting a list of point
To collect a list of point use the key 'L' on the keyboard.
To remember it use the same mental process used for 'Rect'.
Use the firs letter of 'List'
To collect successive mouse position press again 'L' and when you want to get the last point of the list and close the list press 'T' (the last letter of the word 'List')
Than paste the collected code
SetPt(&pt,139,114);MoveTo(pt.h,pt.v);
LineTo(241,274);
LineTo(374,449);
LineTo(548,516);
LineTo(706,460);
LineTo(789,315);
LineTo(795,255);LineTo(pt.h,pt.v);
In this example the code draw a closed polygon using quick Draw.
Personalizing the prefernce you can do what you like with the collected list of coordinates.
• Deleting Previous Coordinate
At any moment you can delete previous collected coordinate by pressing D on the keyboard.
• Changing cursor
You can switch on/off to a cross cursor pressing '+' on the keyboard.
• Coordinate convention
GetMouse4Prog can use 2 different coordinate conventions for tracking and collecting mouse coordinate (horizontal-vertical) and (vertical-horizontal).
You can switch between these two in the preference dialog.
I find this useful as example collecting Rect a to use in Apple Guide code which uses an inverted convention (top-left-bottom-right) and not (left-top-right-bottom) as used in QuickDraw rect.
• Instant Help
The GetMouse4Prog main window help you to work displaying in the bottom only the available hot key.
In the upper left corner is displayed the x-y or y-x convention in use to collect coordinate.
To have further help just press on the keyboard '?' to visualize an extended window with explanations of the hot key you can press on the keyboard.
Shareware
In case you don’t know what is shareware…
Think at shareware as the most direct distribution method, directly from the producer to the user, avoiding distribution costs.
Shareware means freedom of action for developers and very good software with very good service at low prices for users.
The shareware community on the Macintosh side is very strong, both from the developers side and from the users side.
Developers work hard to provide state of the art shareware program and users respect their work.
This doesn't happen on every platform.
Also this make great the Mac, its users.
Registering
If you like GetMouse4Prog and use it, please register.
Shareware registration for GetMouse4Prog is:
Single User License...............US$ 5
Site License.............................US$ 80
World Wide License...............US$ 350
To register you can use Kagi
Kagi
To Pay via ‘Kagi’ use the included 'Register' program.
'Kagi' is the major shareware registration service at the moment and I think you already know it because Kagi Service is used from a lot of shareware authors.
By the way if you don't know it yet this is a brief explanation of how Kagi service works:
Kagi is a company located in U.S.A. specialized in collecting shareware fee and sending them to authors.
Using Kagi service you can select the payment method you prefer from :
Cash, Check, Invoice, VISA, Mastercard, American Express, First Virtual.
Payment are handled via:
normal mail, email, fax, (free USA phone number coming soon).
(Provided card number is automatically encrypted for secure trasmission).
To use the Kagi service use the register program, fill in the data and save the form obtained.
You can send the form via the net or print it and send it via ordinary mail or via fax.
Note: Using Kagi Service do not request additional payment from the users. Shareware fee is the same. (The author pay Kagi the service)
After Kagi receive your payment the author is informed by Kagi within few hours and you will receive your personal registration directly from the author.
Internet
GetMouse4Prog Web Page
Roberto Panetta maintains the 'Tension Software Shareware Page' at this address:
http://www.kagi.com/panetta (USA)
http://www.mclink.it/personal/MC5230 (Europe)
From Tension Software Shareware Page you can read information about the last version of GetMouse4Prog (and other SW by the same author ) and download it.
Contacting the author
To contact Roberto Panetta send mail to:
panetta@kagi.com
Legal Note
Copyright
GetMouse4Prog is copyright Roberto Panetta. All rights reserved.
No modification of the program and of the documentation included is permitted.
Warranty
GetMouse4Prog is supplied 'as is'. The author hereby disclaims all warranties related to this software, whether expressed or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose.
The author will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, or for any claim by any other part, even if the author, or an agent of then author as been advised of the possibility of such damages. In no event shall author' liability for any damages ever exceed the price paid for the license to use the software, regardless of the form of the claim. The person using the software bears all risks as to the quality and performance of the software.
Distribution
This software can be distributed in any 'shareware' form the distributor likes, such as CDs, floppies or via network, as long as the package has all the file of the original package included and unmodified.
If you are a shareware distributor and you distribute my software I like to know that.
Inclusion in commercial packages are prohibited without previous authorization.